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1. INTRODUZIONE 


DESCRIZIONE DEL CAPITOLO 


Vengono qui brevemente descritti Olisort ed i contenuti fisici del suo 
package. Vengono anche trattati il disco di sistema PCOS e le notazioni 
adottate in questo manuale. 
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INTRODUZIONE 


INTRODUZIONE A OL1SORT 


Olisort è un package sort/merge versatile ad alte prestazioni, progettate 
per lavorare su Personal Computer Olivetti M20. La sua ampia gamma di 
prestazioni lo rende utile in quasi tutti i tipi di applicazione ge¬ 
stionale. 

Olisort permette di: 

- eseguire il sort di un file 

- eseguire il merge di due file 

- selezionare un record da un file 

- aggiungere un file alla fine di un altro 

- eseguire sort e selezione contemporaneamente. 

Olisort è comandato da parametri che vengono passati in una stringa 
BASIC. L'intera Stringa di Parametri può essere passata a Olisort tramite 
una stringa di comandi scritta in BASIC, o tramite una breve stringa di 
comandi che fa riferimento a un file parametri. Un file parametri o una 
stringa comandi può essere creata in modo interattivo tramite i programmi 
di utilità Olisort. Ciò significa che si possono facilmente creare lunghe 
stringhe di parametri riducendo apprezzabilmente la possibilità di errori 
di impostazione. 

Si può far funzionare Olisort richiamandolo da un programma BASIC, o 
usando il programma di utilità olisortx. Ciò permette di costruire più 
di un sort in una successione di programmi che operi come un programma 
unico, o di prendere un particolare file ed eseguire immediatamente il 
sort. 

Le più importanti prestazioni interne di Olisort sono le seguenti: 

- possono essere specificate fino a 10 chiavi di sort per record 

- selezione o esclusione di record permessa tramite chiavi Select/Exclude 
(fino a 4) 

- le chiavi Select/Exclude possono essere combinate assieme tramite 
connettori logici "AND" o "OR" 

- per ogni singola chiave Select/Exclude si possono specificare gli e- 
stremi di comparazione: minore, uguale o maggiore 
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- per ogni singola chiave Select/ Exclude si possono usare i caratteri 
o ' ?' : . 

. (*) eguaglia tutti i caratteri successivi 

(?) eguaglia solo il primo carattere successivo 

- con chiavi di sort, Select/Exclude, si può scegliere di attribuire 
lo stesso valore alfabetico per lettere minuscole e maiuscole 

- i dischi usati per i file di lavoro Olisort e per i file di output 
possono essere cambiati; Olisort gestisce automaticamente le segnala¬ 
zioni del cambio al momento opportuno 

- si possono saltare fino a 32.767 record iniziali di un file prima di 
iniziare il sort o il merge 

- vi sono prestazioni per il trattamento degli errori; il codice di sta¬ 
to viene sempre ritornato al programma o al programma di utilità che 
chiama Olisort 

- l'introduzione di Olisort in programmi BASIC esistenti è molto sempli¬ 
ce e non richiede nessuna conoscenza di interfaccia assembler. 

Olisort è progettato specificatamente per funzionare con 1'interprete 

BASIC M20 e supporta record standard di lunghezza fissa con campi di 

lunghezza fissa. 


IL PACKAGE OLISORT 

11 package Olisort è contenuto in un solo disco. Consiste dei seguenti 
file; 

- os.cmd che viene usato per caricare il programma Olisort in memoria 

- olisort.bas è il programma con cui si può chiamare Olisort da un pro¬ 
gramma BASIC 

- olisortx.bas può essere usato per creare stringhe di comandi in modo 
interattivo e per iniziare Olisort automaticamente 

- olisortp.bas con cui si possono costruire file di parametri 

- OLISORT.ABS è l'immagine del programma Olisort 
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Il disco originale non va usato, ma tenuto come copia master. Si può 
costruire da soli un disco Olisort seguendo la procedura di backup de¬ 
scritta nell'appendice B. D'ora in avanti faremo riferimento alla copia 
di lavoro del disco originale come disco Olisort. Notare che sarà molto 
più facile eseguire una copia di backup dopo aver letto il capitolo 3. 

E' anche raccomandabile familiarizzare con il metodo di protezione fisica 
dei dischi in scrittura prima di iniziare a usare il package Olisort 
(Appendice A). 

Il disco originale Olisort è contenuto nella busta del retro-copertina di 
questo manuale. Se manca, lo si può ottenere dal rivenditore Olivetti. 
Nella stessa busta è compreso un Compendio istruzioni, che riassume le 
operazioni di Olisort. 


IL DISCO DI SISTEMA 

Con l’M20 viene sempre fornito un disco di sistema PCOS. Si rende neces¬ 
sario per eseguire copie di backup, formattazioni, etc. Il disco è illu¬ 
strato nella figura 1-1. 



Figura 1-1 Disco di sistema PCOS 







NOTAZIONI USATE IN QUESTO MANUALE 


Se si richiede l'introduzione di un dato, ci si avvale di una notazione 
convenzionale che rappresenta i tasti dell'M20 che è necessario digitare. 
Questa notazione si basa sull'uso di caratteri (bianco su nero,) pe r 
rappresentare i singoli tasti. Per esempio i tasti A, 1, ' , ?, sono rap¬ 
presentati nel modo seguente: 


Ogni tasto da premere è separato con uno spazio dal tasto successivo. Ciò 
non significa che si deve premere la barra di spazio. L introduzione d, 
uno spazio è richiesta espressamente con la notazione EE3S1- 

Tutti i tasti dell'M20, riportano lettere maiuscole. Ciò non significa 
che la pressione del tasto provoca una lettera maiuscola. In verità è 
vero l'opposto. La pressione di qualsiasi tasto alfabetico dà una lette, a 
minuscola. 

Per ottenere una lettera maiuscola si deve premere il tasto K I HIB 
contemporaneamente al tasto alfabetico oppure usare il tasto fissa 
maiuscole. Con la notazione usata in questo manuale, se vogliamo 
introdurre una lettera maiuscola indichiamo la lettera in forma 
maiuscola. 

Per esempio volendo introdurre "lettere minuscole" indichiam- 

HQDHQDE1 EHM* ODDDBQaUBi 

Volendo introdurre "LETTERE MAIUSCOLE" indichiamo 

Il li il II U O li tii^i ODUI9HBI11IIÌ 

Nella maggioranza dei casi il tasto da premere è evidente. Vi sono pero 
alcuni casi non così ovvii, che vengono qui sotto elencati. 

■gfìTCMIiB significa il tasto giallo COMMAND 

significa il tasto blu CTRL 

Billìl significa uno dei due tasti 5H1FT 

«afflai significa la barra spazio 

HI significa il tasto end-of-line a forma di 'L' con su marcata la 
freccia. 
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Per evidenziare la differenza tra la lettera 0 e lo zero mettiamo una 
barra attraverso lo zero (0). 

Facciamo ciò anche quando vogliamo introdurre zero: 0. 

Se si rende necessario premere due tasti contemporaneamente mettiamo un 
segno "+" tra di essi. Per esempio se vogliamo premere il tasto e 

il tasto Qj, indichiamo: M:lH + B|. 


MESSAGGI D'ERRORE 

Nell'uso delle procedure descritte in questo manuale si possono anche 
commettere errori, nel qual caso viene visualizzato un messaggio d'erro¬ 
re. Una lista completa di questi messaggi è riportata nell'appendice D. 

Spesso si tratta soltanto di un errore di digitazione, che può essere 
corretto ridigitando l'informazione esatta. 
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DESCRIZIONE DEL CAPITOLO 


Vengono qui trattati i concetti relativi alla creazione del package 
Olisort e le prestazioni da esso offerte. 

A questo capitolo si può fare riferimento per informazioni relative 
all'uso di Olisort. 
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USO CHIAVI NULTIPLE DI 
SELEZ10NE/ESCLUSI0NE 
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PRESTAZIONI E FUNZIONI 


ESECUZIONE DI OLISORT 

Vi sono due modi per eseguire Olisort: 

- incorporare i parametri in una stringa comandi di un programma BASIC, 
come descritto nel capitolo 5 

- usare il programma di utilità olisortx per la creazione interattiva di 
parametri e quindi far lavorare Olisort come descritto nel capitolo 6. 

In entrambi i casi i parametri passati hanno lo stesso formato. 


PASSAGGIO PARAMETRI A OLISORT 

Vi sono due modi per passare i parametri a Olisort: 

- tramite un file parametri salvato su disco; (utile quando si vuole far 
funzionare lo stesso sort più di una volta). Si può creare un file 
parametri usando il programma di utilità olisortp come descritto nel 
capitolo 4, sotto il titolo Modo 3 

- tramite una stringa comandi che è una variabile BASIC con il nome 
OLISORT.CMDtf. Si può creare una stringa comandi in due modi: 

. usando l'interprete BASIC per creare una stringa comandi come de¬ 
scritto nel capitolo 5 

. usando olisortx per creare una stringa comandi che si può salvare 
su disco, come descritto nel capitolo 6. 

Va notato che l'uso di un file parametri per il passaggio parametri, non 
esclude una breve stringa comandi nel programma BASIC. Questa stringa 
comandi contiene solo pochi parametri e un riferimento al file parametri 
che ne contiene la maggior parte. 


MODI OLISORT 


Uno dei parametri da passare a Olisort specifica il modo voluto. Ci sono 
4 modi Olisort. 
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0L1S0RT MODO 0 


11 Modo 0 permette il sort di un file, la selezione e l'esclusione di 
record da. un file, o il sort e la selezione/esclusione contemporaneamen¬ 
te, 1 parametri per il sort, selezione, o sort e selezione/esclusione, 
devono già esistere in un file parametri su disco. 

Per esempio, se noi abbiamo un master file contenente articoli di magaz¬ 
zino ordinati per codice e due file di transazioni contenenti nuove par¬ 
ti da due. sorgenti diverse, possiamo eseguire il sort dei file transazio¬ 
nali nel modo seguente: 

- creazione di un file parametri per mezzo di olisortp, per eseguire 
il sort dei file transazionali 

- scrittura di un programma BASIC per chiamare due volte Olisort (usando 
lo stesso file parametri ogni volta) per eseguire il sort dei due file 
transazionali. Ciò comporta la preparazione di una stringa comandi 
e la definizione del Modo 0. Questa stringa comandi sarà molto breve, 
poiché la maggior parte dei parametri saranno contenuti nel file para¬ 
metri su disco . 



Figura 2-1 Sort in Modo 0 
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PRESTAZIONI E FUNZIONI 


OLISORT MODO 1 

11 Modo 1 esegue il merge di due file ordinati in uno solo, o aggiunge un 
file alla fine di un altro. Anche sul disco deve essere stato creato un 
file parametri. Se i due file sono stati ordinati e l'informazione chiave 
Sort specificata nel file parametri, verrà eseguito un merge. Se nel file 
parametri non è specificata l’informazione chiave Sort, i due file 
verranno aggiunti in fondo. 

Per esempio, riferendoci ai file transazionali e al master file di cui 
abbiamo parlato nel Modo 0, possiamo eseguire 1'aggiornamento del master 
file nel modo seguente: 

- usando lo stesso file parametri creato per eseguire il sort dei due 
file transazionali, creare un programma BASIC contenente una stringa 
comandi che specifica Modo 1. Specifichiamo i due file di input come i 
nostri due file transazionali ordinati 

- quando il programma BASIC ha girato, i due file transazionali verranno 
fusi (merge) in un file transazionale 

- usando lo stesso file parametri, creare un programma BASIC contenente 
una stringa comandi che specifica il Modo 1. Questa volta i nostri file 
di input sono le transazioni fuse (merge) e il master file 

- quando il programma BASIC ha girato, viene prodotto un master file 
aggiornato. 





figura 2-2 "Merge" in Modo 1 


OL1SORT MODO 2 

11 Modo 2 esegue le stesse funzioni del Modo 0, ma tutti i parametri 
sono passati in una stringa comandi scritta in un programma BASIC. 

Per esempio, possiamo ordinare uno dei file transazionali di cui nel 
Modo 0 nel modo seguente: 
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- scrivere un programma BASIC contenente una stringa comandi che specifi¬ 
ca il Modo 2 


- dopo l'esecuzione del programma BASIC, viene prodotto un file transa¬ 
zionale ordinato. 



Figura 2-3 Sort in Modo 2 


0L1S0RT MODO 3 

11 Modo 3 è identico al Modo 2 , ma su disco viene creato un file dai 
parametri stabiliti nella stringa comandi. Questa prestazione è utile se 
in un programma BASIC è stata scritta una stringa comandi e da essa si 
vuole generare un file parametri. 

Per esempio, si può eseguire il sort dei nostri due file transazionali 
del Modo 0 nel modo seguente: 

- scrivere un programma BASIC contenente una stringa comandi che specifi¬ 
ca il Modo 3. Il file di input per questo sort è il primo file transa¬ 
zionale 

- con l'esclusione del programma BASIC, viene ordinato il primo file 
transazionale, e viene generato un file parametri 

- si scrive allora un altro programma BASIC contenente una stringa coman¬ 
di che specifica il Modo 0 ed usa il file parametri prodotto nell'ul- 
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timo passo. Questa volta il file di input è il secondo file transaziO' 

naie 


3 
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Per semplicità in questo documento ci riferiamo alla massima lunghezza 
di record di 256 byte. 
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TIPI DI CAMPI 0L1S0RT 

Tutti i file devono avere i record di lunghezza fissa. 

Con le chiavi di Sort e Select/Exclude si possono gestire 1 seguenti f| 

tipi di dati: r ' ! 

- stringhe alfanumeriche 

- campi in formato esadecimale 

- numeri interi jfiì 

- numeri in singola precisione pj 

- numeri in doppia precisione. ||i: 

Specificando una stringa alfanumerica con una chiave di Sort o Select/ | 

Exclude, si possono attribuire gli stessi valori ai caratteri maiuscoli | 

e minuscoli. . tìr= 

Specificando campi esadecimali con tasti Sort o Select/Exclude, si chie¬ 
de a Olisort di trattare i caratteri come codici esadecimali. Ciò signi- ; 

fica che le stesse lettere hanno valore diverso per il maiuscolo e il 
minuscolo. 

PRESTAZIONI SORT 

Eseguendo il sort (definendo fino a dieci chiavi) si avrà l’ordinamento 
ascendente o discendente a seconda del parametro: A (ascending) o D (de- 
scending). f| 

Per esempio, si può eseguire il sort di un file in ordine discendente 
di saldi in sospeso, in ordine crescente di stato, per produrre un elen¬ 
co come quello illustrato in figura 2-5. p 


2-7 


STATO 

CLIENTE 

SALDO ($) 

Nevada 

M & M Ltd. 

2596,00 


Zilch & Sons 

1976,55 


ABC Co. 

568,88 

New Jersey 

NXR Ltd. 

8870,77 


Wyatt & Hyatt 

8345,98 


Acme Ltd. 

5689,00 


Olive Oil Co. 

67,43 


Figura 2-5 Elenco saldi in sospeso 

Si può eseguire un sort per ottenere un file di input ordinato, o volen¬ 
do si può anche scrivere sopra al file di input il file di output ordi¬ 
nato (prestazione utile se lo spaziò disco è minime e non si vuole cam¬ 
biare disco durante il sort). Comunque se si verifica un guasto macchi¬ 
na durante la fase di sort, si può perdere il file di input. Se si deci¬ 
de di scrivere sopra il file di input per garantirsi contro eventuali 
guasti macchina, è opportuno eseguire il sort su una copia dell'input 
"Master" del disco che contiene il file di input. La procedura di copia 
di backup è contenuta nell'Appendice B. 


PRESTAZIONI SELEZIONE/ESCLUSIONE 

1 Con Olisort si può generare un file di output che contiene solo i record 
|§'.' selezionati dal file di input. Si può eseguire una selezione/esclusione 
V : contemporaneamente all'esecuzione di un sort o meno. Per esempio, se 
(f decidiamo di eseguire una selezione/esclusione di un sort sul file c1i— 
enti usato nell'ultimo paragrafo, scegliendo di escludere tutti ì clien- 
ti il cui saldo era inferiore a $1000 otteniamo una stampa come quella 
ìS:;' :r illustrata in figura 2-6. 
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STATO 

CLIENTE 

SALDO ($) 

Nevada 

M & M Ltd. 

2596,00 


Zlich & Sons 

1976,55 

New Jersey 

NXR Ltd. 

8870,77 


Wyatt & Hyatt 

8345,98 


Acme Ltd. 

5689,00 


Figura 2-6 Elenco saldi con selezione/esclusione 

1 record possono essere selezionati o esclusi specificando fino a quattro 
chiavi di selezione/esclusione. Queste chiavi sono completamente indi- 
pendenti dalle chiavi di sort che possono essere definite contemporanea¬ 
mente. Ciò significa che si può selezionare o escludere su campi diversi 
da quelli che si stanno ordinando. Se si specificano solo le chiavi di 
selezione/esclusione e non le chiavi di sort, Olisort genera un file 
di output contenente record selezionati ma nello stesso ordine del file 
di inpuU 

Se si specificano stringhe di testo alfanumeriche éntro una chiave 'di 
selezione/esclusione, Olisort controlla che il contenuto della chiave 
e il campo entro il record siano della stessa lunghezza prima di confron¬ 
tarli. La logica di questa procedura è la seguente: 

- prima Olisort verifica se è più lunga la chiave di selezione/esclusio- 
ne o il campo con cui deve essere confrontato 

- agli effetti del confronto il più lungo viene troncato alla lunghezza 
del più corto 

- avviene allora il confronto, carattere per carattere e se tutti i ca¬ 
ratteri sono uguali si ha un riscontro positivo. 

Per esempio se abbiamo un campo in un record tipo questo: 

Tubo di piombo 12 mm x 3 m 

la chiave di selezione potrà essere la seguente: 


Tubo di piombo". 


CARATTERI DI CONFRONTO 


Si possono mettere nella chiave di selezione/esclusione quelli che sono 
chiamati caratteri di confronto: 


< significa che il carattere della chiave sarà considerato minore al 
.corrispondente carattere nel campo confrontato 

> significa che il carattere della chiave verrà considerato maggiore del 
corrispondente carattere nel campo confrontato 

= significa che il carattere della chiave verrà considerato uguale al 
corrispondente carattere nel campo confrontato. 

L'uso dei caratteri di confronto è collegato alla definizione della nota- 
zione "leg" per le chiavi di selezione/esciusione. Tramite "leg", si può 
definire la attuazione della selezione/esclusione se la chiave relativa è 
minore di, uguale A o maggiore di, rispetto al campo sotto confronto. 
Usando i caratteri di confronto si possono fare confronti parziali o con 
chiavi generiche. 

Per esempio, se abbiamo un file di componenti che contiene codici del 
tipo illustrato in figura 2-7, e vogliamo fare una selezione patrie dei 
componenti che appartengono alla classe A, (codice di montaggio uguale a 
80), possiamo usare una chiave selezione/esclusione simile a quella che 
segue : 

80======A 


CODICE DI MONTAGGIO CODICE COMPONENTE CLASSE COMPONENTE 


94 

543678 

B 

67 

553478 

A 

80 

887690 

A 

! 88 

113425 

D 

80 

984400 

C 

80 

000789 

A 

i 56 

I _ 

722990 

8 

Figura 2-7 

Estratto del file componenti 
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Dei dodici componenti riportati in figura 2-7, usando la nostra chiave 
di selezione/esclusione, selezioniamo i seguenti: 

80-887690-A 

80-000789-A 

USO DI CHIAVI MULTIPLE DI SELEZ10NE/ESCLUSI0NE 

L'adozione di più chiavi di selezione/esclusione nel caso dei record, 
richiede l'uso di elementi di connessione come "AND" o "OR". 

Due chiavi di selezione/esclusione collegate da "AND" devono entrambe 
corrispondere ai campi perchè la selezione abbia luogo. 

Se sono invece collegate da "OR", basta che ne corrisponda una perchè 
la selezione avvenga. 

Per chiavi multiple di selezìone/esclusione, dove sono specificate le 
esclusioni, l'elemento di connessione è sempre "OR". In altre parole, 
se abbiamo due chiavi collegate da "AND", per l'esclusione è sufficiente 
un riscontro del record con una sola delle 2 chiavi anziché ambedue. 

Per esempio, se usassimo la seguente combinazione di chiavi, specifican¬ 
do la selezione sui componenti illustrati in figura 2-7: 

80======A OR 80=====C 

selezioneremmo i seguenti codici componenti: 

80-887690-A 

80-984400-C 

80-000789-A 

Mentre se usassimo la seguente combinazione di chiavi sui codici compo¬ 
nenti illustrati in figura 2-7: 

80======A AND 56======8 

non selezioneremmo nessun codice componente. 

Usando chiavi multiple e specificando esclusione e selezione assieme 
sono esaminate per prime le chiavi associate con l'esclusione. Se non 
si ha una situazione di riscontro vengono allora esaminate le chiavi 
associate con la selezione. Se non si ha una situazione di riscontro 
per le chiavi di selezione/esclusione associate con l'esclusione, avvie¬ 
ne l'esclusione del record sotto confronto. 






PRESTAZIONI MERGE 


Olisort permette di eseguire il merge di due file in input ordinati su di 
A' 5 un file in output, o di appendere un file di input in coda ad un altro 
m ottenendo così in output un file che contiene i record del 1 0 + il 2° 
> file di input. 

Per eseguire il "merge" di due file di input, si devono specificare le 
Uè stesse chiavi di sort che si userebbero per ordinare i due file di input. 

, Per aggiungere due file di input, non si devono specificare chiavi di 
Il sort. Il secondo file di input specificato è automaticamente aggiunto in 
i*coda al primo file di input specificato. 


I CAM B IO DISCH I 

; L'uso di parametri appositi permette di richiedere il cambio dei dischi 
durante un sort, merge, selezione/esclusione o sort e selezione/esclu- 
sione. Olisort fornisce automaticamente all'operatore le istruzioni per 
g|il cambio dischi. 

Si possono cambiare i dischi su cui Olisort scrive: 

SU- i suoi file di lavoro di sort 

- il file di output, purché non sia stato specificato che il file di out¬ 
put va riscritto sul file di input per una procedura sort. 

‘per informazioni dettagliate sul cambio dischi vedere l'Appendice F. 


i FILE USATI DA OL ISOR T 

^Olisort può usare fino a cinque file nel suo lavoro: 

1NPUT1: file indispensabile per l'uso del package 

. 1NPUT2: usato quando si vuole utilizzare la prestazione merge e/o 
| append 

I- OUTPUT: è il file in uscita dal sort, merge, append e selezione/esclu- 
i sione. Nel caso che il nome output sia lo stesso dell'input, allora la 
funzione di scrittura sarà effettuata sul file input. 
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PRESTAZIONI E FUNZIONI 


(Questa ultima assegnazione va fatta se si è preventivamente creato un 
file input come Master al fine di sopperire ad eventuali mancanze di 
corrente): 

- BDUMP: file creato da Olisort; è usato per il dump dell'interprete 
BASIC durante l'elaborazione. E* un mezzo per ottimizzare la memoria 
nell'M20 ed aumentare l'efficienza di Olisort. Al termine dell'elabo¬ 
razione, l’interprete BASIC viene automaticamente ricaricato in memoria 
ed il file BDUMP cancellato. 11 file BDUMP occupa 32.768 byte di spazio 
disco 

- SWORK: file di lavoro sort creato da Olisort. Può èssere fino a ~1,7 
volte più grande del file di input. Al termine dell'elaborazione, il 
file di lavoro sort viene automaticamente cancellato. 





3. AVVIAMENTO 


r 


T 


DESCRIZIONE DEL CAPITOLO 


Vengono qui descritti l'avviamento dell'M20, il caricamento dei dischi e 
l’introduzione nell'ambiente PCOS e BASIC. Si riportano anche le modalità 
per listare i file su un disco. 


CONTENUTI 


ACCENSIONE E SPEGNIMENTO 

3-1 

CARICAMENTO DISCHI 

3-2 

AMBIENTI BASIC E PCOS 

3-3 


L1STING DEI CONTENUTI 
01 UN DISCO 
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AVVIAMENTO 



















CARICAMENTO DISCHI 

La fijura 3-2 illustra le semplici modalità di caricamento e rimozione 

dei dischi. 

Da notare comunque alcuni punti: 

- non tentare di forzare un disco nel drive. Se non entra facilmente, 
estrarlo e riprovare 

- nell'inserire un disco nel drive spingerlo completamente fino a senti¬ 
re uno scatto di aggancio 

- togliere i dischi dal drive solo quando la luce rossa (sinistra del 
drive) è spenta (luce rossa accesa = operazione ancora in corso). 


.Tirare il coperchio 
verso l'esterno 



nT) Premere il coperchio 
verso il basso 


© Lasciare aperto 
il coperchio 



(S) Spingere il disco nel drive 
fino allo scatto di aggancio 




(5} Lasciare chiuso 

il coperchio Q 


Figura 3-2 Caricamento e rimozione dischi 


OLISORT - GUIDA UTENTE 




;;-r:ì \ Qijv 3? 1 fr 
i1 12? * t- •/t * :- 
: : ,4 èyves. 

•’ EjJ.acl 3 R d Vn 1 ». e 
‘V 1 ^3dvv\ 


Li -112» >-e’»; 

c ppvs.: i:-ht .:».*; • i-.- ?) 1. tiì V 


AVVIAMENTO 


AMBIENTI BASIC E PCOS 


Prima di poter usare l'Olisort, si deve caricare su M20 il sistema opera 
tivo PCOS. 


A caricamento effettuato appare un messaggio simile al seguente 


11 simbolo " > " viene chiamato prompt PCOS. Si possono introdurre i 
comandi PCOS: VFORMAT, VCOPY, ecc. 


Per uscire dall'ambiente PCOS ed entrare in BASIC, digitare quanto segue 


Appare il seguente messaggio 







-ij r -' 1 è ,iaj Jvi^ifS .^^-'ttr'py'C 


LI ,«2S BflSK-8880 ‘Rtx» 11-©d 

COPYRIGHT (Ci by Oliyetu , 1981, all rights r.eserved 
34391 Bytes free ‘^/*' 

Ok T.:- '■.“■kr'?..■■ Lr- / 




•-*’•*!** • ‘4 •' 


Hi L'interprete BASIC è così caricato, il prompt OK viene chiamato prompt 
■tì BASIC. Quando appare seguito dal cursore si possono introdurre i comandi 
Il BASIC: LOAD, RUM, SAVE, ecc. 


fji LISTINO DEI CONTENUTI DI UN DISCO 

l$f Dopo essere entrati in ambiente BASIC si possono listare i contenuti di 
qualsiasi disco caricato. 

| Per listare i contenuti di un disco, digitare quanto segue: 

§ II II II □ D O drive B G3 


iP Saranno visualizzati tutti i files contenuti sul volume. 
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DESCRIZIONE DEL CAPITOLO 


Vengono qui descritti in dettaglio tutti i parametri che si possono pas¬ 
sare ad Olisort. Si prendono in esame i quattro modi Olisort e vengono 
forniti esempi sulle modalità d'impiego. 1 parametri sono rappresentati 
da abbreviazioni elencate e spiegate in un pieghevole alla fine di questo 
capitolo. Le abbreviazioni sono anche riportate sul retro del Compendio 
istruzioni. . 

Capitolo di tipo didattico, da usarsi anche come riferimento. Per i più 
esperti, comunque, si suggerisce l'uso del Compendio istruzioni. 


CONTENUTI 


PASSAGGIO PARAMETRI 

4-1 

SINTASSI ED ALTRE NOTE 

4-1 

PARAMETRI GENERALI 

4-2 

OLISORT MODO 0 

4-2 

OLISORT MODO 1 

4-3 

OLISORT MODO 2 

4-4 

OLISORT MODO 3 

4-9 



PARAMETRI 


PASSAGGIO PARAMETRI 

Si possono passare parametri a Olisort per mezzo di un file parametri 

tramite una stringa di comandi scritta in BASIC, li passaggio dei parame¬ 

tri è governato dal modo Olisort che si preferisce. 

Si può creare un file parametri nei modi seguenti: 

- usando il programma di Utilità olisortp (capitolo 7) 

- usando il programma di utilità olisortx (capitolo 6) 

- scrivendo una stringa di comandi (capitolo 5) in un programma BASIC. 

Si può creare una stringa comandi nei seguenti modi: 

- codificando la stringa comandi in un programma BASIC (capitolo 5) 

- usando il programma di utilità olisortx per creare interattivamente 
una stringa comandi ed eseguire Olisort automaticamente (capitolo 6) 

- usando il programma di utilità olisortx per creare una stringa comandi 
e .registrarla su disco. Questa stringa comandi può poi essere introdot¬ 
ta in un programma BASIC. 

SINTASSI ED ALTRE NOTE 

La sintassi usata per definire i formati delle stringhe parametri contie¬ 
ne alcuni simboli che hanno un significato speciale. 

t 1 includono parametri opzionali 

! } includono possibili valori per un particolare parametro 
... indicano una serie di parametri simili. 

Tutti gli altri segni di interpunzione appaiono nella stringa parametri 
come nel formato. 

In questo capitolo e nel resto del manuale facciamo riferimento al disco 
Olisort, intendendo per esso la copia di lavoro dell’Olisort master. 

Facciamo anche riferimento ai drive dell'M20 secondo i loro numeri, cioè: 

- il drive di destra = drive 0 
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§p - il drive dì sinistra - drive 1. 

(E' previsto l'utilizzo dell'Hard disk che occuperà la posizione destra. 
Conseguentemente il drive di sinistra diverrà il drive n.0). 


PARAMETRI GENERALI 

1 parametri assegnati vengono passati ad Olisort come una stringa di 
valori separati da asterischi (*) e chiamata stringa parametri 
(OLISORT. CMOS). 

Tale stringa (OLISORT.CMOS) appare in due formati: 

- il primo è una stringa scritta secondo il linguaggio BASIC 

- il secondo è rappresentato dalla stessa stringa registrata su floppy 
disk, diventando, così un file parametri. 

Ogni modo Olisort ha il proprio formato stringa che si avvale di abbre¬ 
viazioni, le cui chiavi si trovano nel pieghevole alla fine di questo 
capitolo, e nel Compendio istruzioni. 


OLISORT MODO 0 

Con il Modo 0 si può eseguire il sort, la selezione/esclusione o le due 
operazioni insieme, basandosi sui parametri di sort passati tramite un 
file parametri, precedentemente memorizzato su disco per mezzo del 
Modo 3. 

11 formato della stringa parametri è il seguente: 

0*sd*bd*p:parmfile* 


Esempio 

1|| Abbiamo creato un file parametri chiamato PARAMI sul disco del drive 1. 
2 11 disco Olisort è sul drive 0, il file BDUMP sul disco 0 isort ed 

eseguirà un sort come specificato dai parametri definiti nel relativo 

' file. 

_ Se codifichiamo la nostra stringa comandi in un programma BASIC, essa 
§s$2 diventa simile a: 


ni icnDT _ CllinA UTENTE 


PARAMETRI 


OL1SORT.CMD$="0*0*0*1: PARAMI*" 


OL1SORT MODO 1 

Con il Modo 1 si può eseguire il merge di due file ordinati, o aggiungere 
il file in coda a un altro, usando un file parametri creato in prece¬ 
denza. 

11 formato della stringa parametri per il Modo 1 è il seguente: 

1 *sd*bd*p : parafi le*i1 : input1*i2:input2*o .-output* 

1 contenuti del file parametri determinano l'esecuzione di un merge o un 
append: 

- se non è specificata nessuna chiave sort nel file parametri, i2:input2 
è aggiunto in coda a Ì1:input1. 11 risultato è messo in oroutput 

- se sono specificate chiavi sort, devono essere quelle usate per esegui¬ 
re il sort dei due file di input. In questo caso, ilùnputl è fuso con 
Ì2:input2 ed il risultato viene messo in o:output. 


Esempi 

Merge: abbiamo due file ordinati (TRAN1 e TRAN2), sullo stesso disco, e 
vogliamo unirli per produrre un file unico (TRAN), sempre sullo stesso 
disco, dove abbiamo già creato un file parametri (PARAM2), che contiene 
le chiavi di sort. Questo disco è caricato nel drive 1. 

11 disco Olisort è nel drive 0 e vogliamo che Olisort vi scriva il pro¬ 
prio file 80UMP. 

Se codifichiamo la stringa comandi in un programma BASIC si avrà: 

OLISORT.CMD$="1*0*0*1:PARAM2*1:TRAN1*1:TRAN2*1: TRAN*" 

Append: abbiamo due file non ordinati (BILLS1 e B1LLS2) sullo stesso 
disco e vogliamo metterli uno in coda all'altro per produrre un file 
unico (BlllS) sempre sullo stesso disco, dove abbiamo già creato un file 
parametri (PARAM3) che non conterrà informazioni di chiavi di sort. 
Questo disco è sul drive 1. 

11 disco Olisort, in cui Olisort registrerà il file BDUMP, è nel drive 0. 
La stringa comandi codificata in un programma BASIC, apparirà nel modo 
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seguente: 


OL1SORT.CMD$="1*0*0*1:PARAM3*1:B1LLS1*1:BILLS2*1:B1LLS*" 

0L1S0RT MODO 2 

Col Modo 2 si può eseguire il sort, la selezione/esclusione o le due 
operazioni insieme. Tutti i parametri vengono passati in una stringa 
comandi di un programma BASIC. 

Nei seguenti esempi la chiave SORT è: 

fs*fl*ft*ad 

e la chiave SELECT/EXCLUDE è: 
fs*fl*ft*dr*leg*valore chiave 

La stringa parametri ha i seguenti formati: 

- Per un sor t 

2*sd*bd*i1:input1*o:output*skp*rl*cw*co*w*S0RT-KEY-1[*S0RT-KEY-2- 

*SORT-KEY-10 ]*0*AND*(f* 

- Per una selezione / esclusione 

2*sd*bd*i1 :input1*o:output*skp*rl*cw*co*w*0*'jgj^j*SELECT-EXCLUDE-KEY-1 

^0R D }* SELECT ’ EXaUDE " KEY ’ 2 ' ‘ *SELECT-EXCLUDE-K£Y~4]*0* 

- Per un sort con se lezione/es cl usione 

2*sd*bd*i1:input1*o:output*skp*rl*cw*co*w*S0RT-KEY-1[*S0RT-KEY-2—. 

SORT-KEY-10l*0*|^°|*SELECT-EXCLUDE-KEY-l[*|^ D j'*SELECT-EXaUDE-KEY- 

2-*{ AND (-*SELECT-EXCLUDE-KEY-4]*0* 

\0R J 
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PARAMETRI 


Note 

Notare che la lista delle chiavi di sort e di select/exclude termina 
sempre con’uno 0. Deve inoltre esservi un elemento di connessione fra le 
chiavi di sort e quelle di select/exclude. 

Quindi 0 "AND" è usato per indicare la fine delle chiavi sort e che eie 
che segue va considerato come un elenco di chiavi selezione/esclusione. 

Lo zero significa fine delle chiavi di selezione/esclusione. Abbiamo i 
seguenti casi particolari: 

- se non ci sono chiavi di selezione/esclusione, si chiude allora l'elen¬ 
co delle chiavi sort con 0*AND*0* 

- se non ci sono chiavi di sort si inizia l'elenco delle chiavi di sele¬ 
zione/esclusione con 0*AND*. 


Esempi 

Per illustrare l'uso del Modo 2, estrarremo parte di un immaginario file 
di magazzino di un commerciante di utensileria. L'estratto è riportato in 
figura 4-1. 

Ogni record nel file è così composto: 

- CODICE COMPONENTE: 5 caratteri, l'ultimo carattere è una H per articoli 
di magazzino House/Hobby, o una P per articoli di magazzino Profes¬ 
sionali 

- DESCRIZIONE: un massimo di 45 caratteri 

- GIACENZA DI MAGAZZINO: numero intero 

- SCORTA A MAGAZZINO: numero intero indicante la quantità minima a 
magazzino in base alla quale emettere un ordine al fornitore. 

11 nome del file è STOCK.EXT. 

A seconda delle variabili considerate, si avrà una diversa occupazione di 
byte: 

- valore alfanumerico = 1 byte 

- numero intero = 2 byte 
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singola precisione = 4 byte 
doppia precisione = 8 byte. 


. 

CODICE 

descrizione 

GIACENZA 

SCORTA 

MINIMA 

i 

1 ì 1009 H 

Rover Orili 2-speed 

40 

35 

2 ! 2214 H 

Ciroiiar Say ftttachaent 

34 

40 

3 ! 0309 P 

Orili Bit 4gs. 

BO 

85 

4 ! 4545 P 

Orbitai Sander 

31 

40 

5 : 1114 H 

Power Orili single speed 

24 

35 

6 ! 2179 P 

Circolar 5av Attacheent 

54 

45 

7 ! 1033 H 

Power Orili 3 speed 

24 

35 

B ! 0555 P 

Orili Bit 8s#. 

45 

70 

9 1 7144 H 

Balt Sander 

55 

30 

10 ! 0354 H 

Orili Bit 4t*. 

56 

75 


Figura 4-1 Estratto file di magazzino 

Sort: per prima cosa poniamo il file in ordine di codice all'interno del 
livello di scorta minima. Per fare ciò dobbiamo usare due chiavi di sort, 
specificandole in ordine d'importanza. Cioè, la prima chiave sort 
relativa al livello di scorta minima corrispondente al raggruppamento 
principale, e la seconda chiave di sort sara per il codice, raggruppa 
mento secondario. 

Le chiavi di sort sono le seguenti: 

- 53*2*1*A* (scorta a magazzino) 

- 1*5*A*A* (codice). 

Desideriamo registrare il nostro file di output STOCK.SRT sullo stesso 
disco del file di input, che verrà caricato sul drive 1. Chiedi» 
Olisort di scrivere tutti i file di lavoro sort sul disco nel drive 1, 
mentre invece il disco Olisort sarà sul drive 0, e su di 
registrerà il file BDUMP. 

La stringa di comando in un programma BASIC sarà la seguente: 
OLISORT.CMD$="2*0*0*1: STOCK.EXT*1: STOCK. SRT*0*54*N*N*1*53*2*1*A*1*5*A*A* 

0*AND*0*“ 


lì;' 4-s 
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PARAMETRI 


Dopo l'esecuzione del programma che conteneva questa stringa di comandi 
otterremo un output simile a quello illustrato in figura 4-2: 



CODICE 

DESCRIZIONE 

GIACENZA 

SCORTA 

MINIMA 

1 

! 7164 H 

Belt 5ander 

55 

30 

2 

: 1009 H 

Pover Orili 2-speed 

40 

35 

3 

: 1033 H 

Rover Orili 3 speed 

26 

35 

4 

! 1114 H 

Pover Orili single speed 

26 

35 

5 

! 2214 H 

Circular 5av Attachsent 

34 

40 , 

6 

1 4565 P 

Orbitai Sander 

31 

40 

7 

1 2179 P 

Circular 5av Attachsent 

54 

45 

8 

! 0555 P 

Orili Bit Sa. 

45 

70 

9 

1 0356 H 

Orili Bit 4 m. 

56 

75 

10 

1 0309 P 

Orili Bit 4sa. 

80 

85 


Figura 4-2 File di magazzino ordinato 

Select/Exclude: vogliamo selezionare dal file di magazzino le punte da 
trapano di qualità professionale, cioè gli articoli di magazzino la cui 
descrizione comincia con "Orili bit" (Punte da trapano), ed il cui codice 
termina con la lettera P.. 

Per fare ciò abbiamo bisogno di due chiavi di selezione/esclusione 
collegate da "AND". 11 loro ordine di apparizione nella stringa parametri 
è irrilevante. 

Chiediamo a Olisort di scrivere i suoi file di lavoro sort sul disco nel 
drive 1, ed il file BOUMP sul drive 0 che contiene il file di input e 
dove registriamo il file di output. 

Scriviamo la nostra stringa comandi nel modo seguente: 

OLISORT.CMD$="2*0*0*1: STOCK.EXT*1: STOCK.SE*O*54*N*N*1*0*AND*6*9*A*R*E* 
drill bit*AND*5*1*A*O*E*H*0*. 


Vediamo in maggior dettaglio la stringa di comandi: 

- nella prima chiave di selezione/esclusione abbiamo specificato il valo¬ 
re chiave come "drill bit". 11 segno "=" è il carattere di confronto 
trattato nel capitolo 2. Ciò significa che qualsiasi carattere appaia 
nel record nella posizione corrispondente verrà considerato uguale al 
valore chiave. Per esempio, se la descrizione di un articolo di 
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magazzino inizia "drill-bit" verrà ancora considerato uguale alla prima 
chiave di selezione/esclusione. Poiché abbiamo specificato il tipo di 
campo (ft) = A, la descrizione nel record, per la frase "Orili Bit , 
può iniziare con lettera maiuscola o minuscola e avrà ancora riscontro 
con la chiave di selezione/esclusione. Per esempio, DRILL-BIT, drill 
bit, Drill*BlT e Drill. Bit, sono tutti considerati uguali alla chiave 
di selezione/esclusione. 

- nella seconda chiave di selezione/esclusione abbiamo specificato 'D' 
come indicatore di Cancellazione/Mantenimento. Ciò significa che esclu¬ 
diamo i record che hanno riscontro positivo con questa chiave dal file 
di output. Escluderemmo tutti gli articoli di magazzino il cui codice 
termina con la lettera H, per selezionare tutti quelli che terminano 
con la lettera P. Ciò soltanto per specificare la selezione o l'esclu¬ 
sione. Potremmo aver specificato 'R‘ per mantenimento e indicato in "P" 
il valore chiave. Per il nostro estratto di file magazzino, ciò avrebbe 
esattamente lo stesso effetto. 

Quando facciamo girare il programma che contiene la stringa comandi otte¬ 
niamo il file illustrato in figura 4-3. 



Figura 4-3 Selezione/esclusione su file di magazzino 

Sort e Select/Exclude: vogliamo selezionare tutti gli articoli di magaz¬ 
zino nella categoria 'House/Hobby e ordinarli secondo il numero di codice. 
Per fare ciò dobbiamo avere una chiave di sort ed una chiave di sele¬ 
zione/esclusione. 

Mettiamo il file di output sullo stesso disco di STOCK.EXT e lo chiamiamo 
STOCK/SSE. Chiediamo ad Olisort di registrare su questo stesso disco 
(drive 0) il suo file 8DUMP ed ogni file di lavoro sort. 

11 disco OLISORT verrà caricato nel drive 1. 

La stringa comandi sarà la seguente: 


OLISORT - GUIDA UTENTE 
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PARAMETRI 


0L1S0RT.CMD$="2*1*0*0*:STOCK.EXT*0: STOCK.SSE*0*54*N*N*0*1*5*A*A*AND*5*1* 
A*r*e*H*0*" 

Oalla esecuzione del programma BASIC che contiene questa stringa di co¬ 
mando, otteniamo l'output di cui in figura 4-4. 



CODICE 

DESCRIZIONE 

GIACENZA 

SCORTA 

MINIMA 

1 

: 0356 H 

Drill Bit 4ob, 

56 

75 

2 

1 1009 H 

Power Orili 2-spèed 

40 

35 

3 

: 1033 H 

Power Orili 3 speed 

26 

35 

4 

! 1114 H 

Power Orili single speed 

26 

35 

5 

ì 2214 H 

diradar Saw Attachaent 

34 

40 

6 

! 7144 H 

Belt Satider 

1 

55 

30 


Figura 4-4 File di magazzino dopo un Sort o selezione/esclusione 

OL1SORT MODO 3 

11 Modo 3 opera esattamente come il Modo 2 ma la stringa comandi è cari¬ 
cata su disco. Il file parametri contiene i dati che erano stati scritti 
nella stringa comandi. 

E' una prestazione utile per il sort, la selezione/esclusione o le due 
operazioni insieme, su più di un file usando le stesse chiavi. (Capitolo 
2 "Prestazioni selézione/esclusione"). 

Negli esempi seguenti la chiave di SORT è: 

fs*fl*ft*ad 

e la chiave di SELECT/EXCLUDE è: 

fs*fl*ft*dr*leg*chiave 

I tre formati di stringa parametri per il Modo 3 sono i seguenti: 

- Per il Sort 


3*sd*bd*p*parmfile*i1:input1*o:output*skp*rl*cw*co*w*S0RT-KEY-1 

[♦SORT-KEY-2....*SORT-KEY-10]*0*AND*0* 


4-9 





- Per Selezione/Esclusione 

*rt*/AND\ 

3*sd*bd*p:parmfile*i1 : input 1 *o:output*skp*rl*cw*co*w *0 j- 

*SELECT-EXCLUDE-KEY-1 [|q R D J> *SELECT-EXCLUDE-KEY-2...-<jg R } 

*SELECT-EXCLUQE-KEY-4]*0* 

_ Per Sort con Selezione/Esclusione 

3*sd*bd*p:parmfile*i1 : input"! *o:output*skp*rl*cw*co*w*S0RT-KEY-1 
[*S(JRT~KEY-2_SORT-KEY-10]*0*j* R D j*SELECT-EXCLUDE-KEY-1 

l *{oR D )* 5aECT ' EXCLUDE " KEY ' 2 ' ‘ ‘-*{ A OR D h SELECT ' LXaUDE ' KEY " 41 * 0 * 


Note 

Notare che la lista delle chiavi di sort e di select/exclude termina 
sempre con uno 0. Deve inoltre esservi un elemento di connessione fra e 
chiavi di sort e quelle di select/exclude. 

Quindi 0*AND è usato per indicare la fine delle chiavi sort e che quanto 
segue va considerato come una lista di chiavi di selezione/esclusione. 

Lo zero significa fine delle chiavi di selezione/esclusione. 

Abbiamo allora i seguenti casi particolari: 


non ci sono chiavi di selezione/esclusione. Terminiamo allora la lista 
delle chiavi di sort con 0*AND*0* 


- non ci sono chiavi di sort. 
esclusione con 0*AND*. 


Iniziamo la lista delle chiavi selezione/ 


IMO 
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PARAMETRI 


Esempio 

Se rivediamo l'esempio di Sort del Modo 2 (questa volta per il Modo 3), 
la nostra stringa comandi sarà: 

0L1S0RT.CMD$="3*0*0*1* :PARAM4*1: STOCK.EXT*1: STOCK.SRT*0*54*N*N*1*53*2*1* 
A*1*5*A*A*0*AND*0* 

Dopo l'esecuzione del programma BASIC contenente questa stringa comandi, 
otterremo lo stesso file di output precedente (vedere figura 4-1). Sullo 
stesso disco troviamo comunque un file (PARAM4) che conterrà i parametri 
della stringa comandi. Potremo usare il file parametri per il sort di 
STOCK.EXT ancora in Modo 0. Questa volta scriveremo la seguente stringa 
comandi: 

OLISORT.CMD$="0*0*0*1:PARAM4" 
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5. INTRODUZIONE STRINGHE COMANDO 
IN PROGRAMMI BASIC 


J':' DESCRIZIONE DEL CAPITOLO 

Vengono qui descritte le modalità di introduzione di una stringa comandi 
in un programma BASIC, ma non i contenuti della stringa trattati nel 
Ijt; capitolo 4. 

Il Per inserire stringhe comandi in programmi BASIC, è necessario essere a 
conoscenza del linguaggio di programmazione. 

i..V p er imparare a programmare in BASIC, fare riferimento al manuale 
^ J "Linguaggio BASIC - Manuale generale " (3982420 N). 



CONTENUTI 

GENERALITÀ' 

USO DEL PROGR AMMA DI INTER¬ 
FACCIA 0LIS0RT 

ESEMPIO 


5-1 

5-2 

5-3 




INTRODUZIONE STRINGHE COMANDO IN PROGRAMMI BASIC 


GENERALITÀ’ 


Come detto in precedenza si può iniziare Olisort con un programma BASIC, 
già esistente o nuovo. In entrambi i casi si deve usare il programma di 
interfaccia. 

Questo programma (olisort.bas) risiede sul disco Olisort (vedi Figura 
5-1); 


65000 REO OLISORT.BUS BASIC INTERFACE PROGRAM FOR OLISORT 
65060 REH 

65070 REO Copyright (c) 1982 OLIVETTI. All Rights Reserved. 
65080 REM 

65100 OLISORT.ERR0RI=Q 
65110 OLISORT.CttTZ-fl 

65120 CALL *os* «OLISORT.CHOK,dOLISORT.ERROftZ,iOLISORT.CWTZJ 
65130 RETURN 


Figura 5-1 Programma di interfaccia Olisort.. 

Non si tratta di un programma nel vero senso della parola, perchè non 
funziona fino a che non viene modificato, dopodiché lo si può far girare 
da solo o assieme ad altri programmi BASIC più ampi. 

Olisort passa sempre un codice di stato al programma chiamante in una 
variabile BASIC chiamata OLISORT. ERRORV Questa variabile può essere 
testata nel modo consueto. Se, durante l'esecuzione, viene rilevato un 
errore, Olisort ricarica l'interprete BASIC e ritorna il controllo al 
programma chiamante. E' quindi logico testare OLISORT.ERRORI, dopo ogni 
chiamata a Olisort nel programma BASIC. Un elenco completo dei codici di 
stato è riportata nell'appendice E. 

La regolare esecuzione di Olisort è indicata da un codice di stato uguale 
a zero visualizzato al termine dell'elaborazione. 


Con il programma BASIC, si può chiamare Olisort un numero indefinito di 





USO DEL PRO GRAMMA DI IN TE RFACCIA O LISORT 

Prima di usare il programma di interfaccia Olisort si deve entrare in 
ambiente BASIC, come descritto nel capitolo 3, e caricare il disco 
Olisort sul drive 0. 

Per caricare il programma di interfaccia Olisort in memoria introdurre 
quanto segue: 


Quando appare il prompt BASIC, il programma è stato caricato e lo si può 
listare sullo, schermo digitando: 

ii n □ a iìi 

o stamparlo digitando: 

■inmiDEa 

Il listing del programma è illustrato in figura 5-1. 

Come si può vedere la subroutine che chiama Olisort è nell'istruzione 
65000 , quindi le righe da 1 a 64999 sono disponibili per il programma 
BASIC. 

Per chiamare Olisort si devono introdurre due linee di codice: una 
definirà la variabile OLISORT.CMD$, che contiene la stringa comando, e 
l'altra sarà GOSUB 65000, che chiama Olisort. 

Dopo G0SU8 65000 , si deve anche includere un'altra istruzione, che testi 
il contenuto di OLISORT.ERRORE, insieme a OLISORT.CNT% che corrisponde al 
commutatore di record. 

Dopo aver modificato il programma di interfaccia Olisort, lo si può 
memorizzare sul disco Olisort digitando quanto segue: 

BDDDHOII intprog HI ■ Bea 

dove intprog è il nome che si vuol dare alla versione modificata (per 
poter effettuare ulteriori operazioni di ’Merge', occorre salvare il 
programma in formato ASCII). Quando appare il prompt BASIC il programma è 
stato memorizzato. 

Ora si può far girare il programma o eseguire il suo merge con un altro 
programma BASIC. Se si vuole far girare la versione modificata come 
programma autonomo, si può digitare: 
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INTRODUZIONE STRINGHE COMANDO IN PROGRAMMI BASIC 


DOOHEIB intprg m EOI 

Per eseguire il merge con un programma BASIC, si deve caricare i: 
programma BASIC in memoria e digitare: 

raBncnauEflai int prg m un 

All'apparire del prompt BASIC, l'operazione di "merge" è stata eseguita. 

Se si sta eseguendo il merge di una versione modificata del programma c: 
interfaccia Qlisort in un programma BASIC occorre tener presenti !< 
seguenti limitazioni: 

- il programma BASIC non deve avere nessun numero di riga maggiore di 
64999 

- il programma BASIC non deve contenere nessun numero di riga uguale a 
quelli introdotti nel programma di interfaccia Olisort per modificarlo. 


ESEMPIO 


Ritorniamo all'esempio di file magazzino usato nel capitolo 4, illustrate 
in figura 4-1. 

Abbiamo un programma che lista STOCK.EXT e risiede sullo stesso disco. Il 
programma è chiamato STOCKLIST. Vogliamo inserire una chiamata a Olisort 
dentro STOCKLIST, così da ottenere un listing in ordine discendente dei 
codici componenti. 

Per fare ciò procediamo nel modo seguente. 

Entriamo innanzitutto in ambiente BASIC. Carichiamo il disco Olisort nel 
drive 0, e il disco contenente STOCKLIST e STOCK.EXT nel drive 1. 

Ora introduciamo: 


UQciiaiiriniiiiKiannaiiiin n 

HG3 

All'apparire del prompt BASIC, il programma è caricato. 

Il nostro programma 5T0CKL1ST inizia alla riga 200 e termina alla 400. 
Ciò significa che possiamo disporre dei numeri di riga da 1 a 199 per le 


nostre istruzioni di chiamata a Olisort. Scegliamo di partire alla linea 
100. Introduciamo le seguenti istruzioni BASIC: 

100 OL1SORT.CMD$="2*0*0*1: STOCK.EXT*1: STOCK.SRT1*0*54*N*N*1*1*5*A*D*0* 
AND*0*" 

110 GOSUB 65000 

120 1F OLISORT.ERROR%=0 THEN GOTO 200 ELSE PR1NT OLISORT.ERR0R% 

130 END 

Abbiamo modificato il programma di interfaccia Olisort e vogliamo 
memorizzare la versione modificata sul disco Olisort, prima di eseguire 
il merge con ST0CKL1ST. Per fare ciò digitiamo: 

□ □aauiiBnnHaEiniinnu oa 

All'apparire del prompt BASIC il programma è stato memorizzato. 

Per eseguire il mèrge introduciamo: 

EiauiiaimBiiaoBODiiiiiHB 

■ Gl 

dove : 

ST0CKL1ST è stato salvato in formato ASCII. 

Quando appare il prompt BASIC, il merge del programma è stato eseguito. 

Prima di eseguire il programma vogliamo memorizzarne una copia sullo 
stesso disco di ST0CKL1ST. Digitiamo: 

BBnDrau^nnHHEiiiiiK£a 

Quando appare il prompt BASIC abbiamo un programma LISTA sul disco del 
drive 1, che classificherà il nostro File Stock in ordine discendente di 
codice e lo stamperà. Poiché il programma è ancora in memoria ed anche 
sul disco, possiamo farlo girare digitando: 


DBDGa 

Indi appare sullo schermo il seguente messaggio: 


INTRODUZIONE STRINGHE COMANDO IN PROGRAMMI BASIC 


Calling OLISORT 

SORT INPUT AND SELECT PHASE 
RECORDS READ OR SK1PPED=10 
RECORDS SELECTED=10 
OUTPUT PHASE 

10 RECORDS WR1TTEN TO OUTPUT FILE 


11 programma darà allora il listing riportato in Figura 5-2. 


CODICE DESCRIZIONE 


GIACENZA 


SCORTA 

MINIMA 


1 

1 7144 H 

Bell Sander 

55 

30 

2 

! 4545 P 

Orbitai Sander 

31 

40 

3 

ì 2214 H 

Circolar 5au Attachiert 

34 

40 

4 

1 2179 P 

Circolar 5aw fittach»ent 

54 

45 

5 

! 1114 H 

Power Orili single speed 

24 

35 

6 

! 1033 H 

Power Orili 3 speed 

24 

35 

? 

! 1009 H 

Power Orili 2-speed 

40 

35 

a 

1 0555 P 

Orili Bit 6», 

45 

70 

!» 

! 0354 H 

Orili Bit 4 m. 

54 

75 

10 

1 0309 P 

Orili Bit 4u, 

BO 

85 








DESCRIZIONE DEL CAPITOLO 


Vengono qui descritte le modalità d'uso del programma di utilità 
olisortx che consente la creazione interattiva di stringhe di comando. 

Questo programma di utilità, che è autoesplicativo, riduce le possibili¬ 
tà d'errore in caso di stringhe di comando piuttosto lunghe. 


CONTENUTI 


GENERALITÀ' 

6-1 

MESSAGGI 0'ERRORE STANDARD 

6-1 

ESECUZIONE DI olisortx 

6-1 

MENU DELLE OPZIONI OLISORTX 

6-2 

INTRODUZIONE CHIAVI DI SORT 

6-4 

INTRODUZIONE CHIAVI DI 
SELECT/EXCLUDE 

6-5 

VISUALIZZAZIONE STRINGA 
COMANDI 
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PROGRAMMA DI UTILITÀ' olisortx 


GENERALITÀ 1 

11 programma di utilità olisortx risiede sul disco Olisort col nome 

olisortx.bas. 

olisortx serve principalmente per effettuare: 

- il Sort, la selezione/esclusione, le due operazioni assieme, il Merge o 
l'Append su un file esistente. E' il modo migliore per generare le 
stringhe comandi del Modo 2 se si vuole usare Olisort per elaborare un 
file una sola volta (opzione S) 

- la creazione di una stringa comandi e la successiva memorizzazione su 
disco per eseguire il suo merge in un programma BASIC (opzione C) 

- la creazione di una stringa comandi da visualizzare sullo schermo in 
modo da poter copiare la forma corretta della stringa comandi, per 
codificarla in un programma BASIC (opzione B). 


MESSAGGI D'ERRORE STANDARD 

11 programma di utilità olisortx permette di costruire una stringa 
comandi tramite 'una serie di prompt che appaiono sullo schermo. La 
risposta ad ognuno di questi prompt deve essere chiusa premendo il tasto 

IBI . 

Nel dare le risposte, può apparire il seguente messaggio d'errore: 
»Invalid Response. Please re-enter. 

Si può allora ridigitare la risposta, assicurandosi che sia nei limiti 
definiti dal prompt. 


ES ECUZIONE DI olisortx 

Entrare in ambiente BASIC con il disco Olisort sul drive 0, come 
descritto nel capitolo 3. 

Quando appare il prompt BASIC, digitare quanto segue: 


6-1 







PROGRAMMA DI UTILITÀ' olìsortx 


Si deve ora digitare Uri . Q, oppure h, a seconda del modo che si 
vuole usare. Si richiedono i parametri che costituiscono la stringa 
comandi. 

La tabella 6-1 riporta i prompt che appaiono per i vari modi ed i 
corrispondenti parametri da introdurre. 1 parametri sono riportati nella 
loro forma abbreviata come nel pieghevole alla fine del capitolo 4 e nel 
Compendio istruzioni. 

MODI PER CUI PARAMETRO 




PROMPT OLÌSORTX 

APPARE IL 
PROMPT 

DA 1NTR0' 

DURRE 

Enter 

12) 

drive 

I.D. for sort program (0,1,10,11, 

Tutti 

sd 

Enter 

10,11, 

drive 

12) 

I.D. for memory Storage file (0,1, 

Tutti 

bd 

Enter 

11,12) 

drive 

1.0. for parameter file (0,1,10, 

0, 1, e 3 

P 

Enter 

parameter file name (0,1,10,11,12) 

0, 1, e 3 

parmfile 

Enter 

drive 

I.D. for input file (0,1,10,11,12) 

2 e 3 

il 

Enter 

input 

file name: 

2 e 3 

imputi 

Enter 

12) 

drive 

I.D. for Input File 1 (0,1,10,11, 

1 

il 

Enter 

Input 

1 file name (0,1,10,11,12) 

1 

inputl 

Enter 

12 

drive 

I.D. for input file 2 (0,1,10,11, 

1 

i2 

Enter 

input 

2 file name: 

1 

inpt ^ 

Enter 

drive 

for output file (0,1,10,11,12) 

1, 2 e 3 

0 

Enter 

output 

file name: 

1, 2 e 3 ’ 

output 

Enter 

number 

of records to skip (0-32767): 

2 e 3 

skp 

Enter 

record 

1 length: 

2 e 3 

ri 
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Change work disk? (V/N): 

2 e 3 

cw 

Change output disk? (Y/N): 

2 e 3 

co 

Enter drive l.D. for work file (0-10): 

2 e 3 

w 


Tabella 6-1 Parametri per olisortx 

INTRODUZIONE CHIAVI DI SORT 

Se si scelgono i Modi 2 o 3, appare il seguente prompt: 

Enter number of sort Keys (0-10): 

Si deve introdurre un numero intero compreso tra 0 e 10, che definisce il 
numero di chiavi Sort che si vogliono creare. L'introduzione di 0 indica 
che nessuna chiave di Sort va introdotta. 

L'introduzione di qualsiasi altro numero / 0 provoca la visualizzazione 
di un messaggio che richiede l'introduzione di ogni singola chiave di 
sort : 

Enter parameters for sort Key n 

Dove n è il numero della chiave di sort da introdurre subito dopo. 

1 prompt per ogni chiave di sort e i parametri da introdurre sono 
illustrati nella tabella 6-2. 1 parametri sono nella loro forma abbrevia¬ 
ta come nel pieghevole del capitolo 4 e nel Compendio istruzioni. 
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PROGRAMMA DI UTILITÀ' ousortx 


PROMPT DELLA CHIAVE DI SORT PARAMETRO NOTE 

Starting position (1 —r1) fs Dove ri = valore da intro 

durre per primo 

Key length (1-n) fi Dove n = ri meno fs. Se 

si introduce un valore 
maggiore di n, appare il 
seguente messaggio d'erro 
re : 

»key extends past end 
of record 

Si deve introdurre un va¬ 
lore inferiore a n. 

Field Type: 

(A=Alpha H=Hex l=Int ft 

S=sngl.Prec D=Dbl.Prec) 

Sort in Ascending or Descending ad 

order (A/D) 

i 

Tabella 6-2 Prompt delle chiavi di sort. 

Dopo aver introdotto l'ultima chiave di sort, si richiede l'introduzione 
di qualsiasi chiave di selezione/esclusione. 


INTRODUZIONE CHIAVI DI SELECT/EXCLUDE 
Appare il seguente messaggio: 

Enter thè number of select keys (0-4); 

Si deve ora introdurre un numero compreso tra 0 e 4 che specifichi il 
numero di chiavi Select/Exclude che si vogliono creare. Se si introduce 
0, non si deve creare alcuna chiave e si può procedere con la 
"Visualizzazione Stringa Comandi". 

Se si introduce un numero compreso tra 1 e 4 allora si richiede l'intro¬ 
duzione sequenziale delle singole chiavi di Select/Exclude. 

I prompt per ogni chiave di Select/Exclude ed i parametri da introdurre 
sono indicati nella tabella 6-3; i parametri sono nella loro forma 
abbreviata come riportato nel pieghevole del capitolo 4 e nel Compendio 
istruzioni. 
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PROMPT CHIAVI SELECT/EXCLUDE PARAMETRI 


NOTE 


Starting position (1-rl) fs Dove ri - valore richie¬ 

sto in precedenza per la 
introduzione. 

key length ( 1 —n) .fi Dove n=rl-fs. Se si in¬ 

troduce un valore più 
grande di n appare il se¬ 
guente messaggio d'erro¬ 
re: 

»key extends past end 
of record 

Introdurre un valore in¬ 
feriore a n. 

Field Type: ft 

(A=Alpha H=Hex l=lnt 
S=Sngl.Prec D=Dbl.Prec) 

Retain or Oelete (R/D) rd 

Comparison type: leg 

(L=less than E=equal to 
G=greater than) 

Select key value: valore 

chiave 

Tabella 6-3 Prompt chiavi selezione/esclusione. 

Dopo aver introdotto l'ultima chiave di Select/Exclude si visualizza la 
stringa comandi creata, come descritto nel paragrafo che segue. 

VISUALIZZAZIONE STRINGA COMANDI 
Se si sceglie l'opzione C 
appare il seguente messaggio: 

Enter drive l.D. for Command String File (0-1): 

Introdurre il numero del drive che contiene il disco e su cui si desidera 
la scrittura della stringa comandi. 
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PROGRAMMA DI UTILITÀ' olisortx 


Appare il seguente messaggio: 

Enter Command String File name: 

Introdurre qualsiasi nome di file valido, che verrà assegnato al file 
Stringa Comandi su disco. 

Appare il seguente messaggio: 

Enter line number for Command String: 

Introdurre un numero di riga compreso fra 1 e 64999. Su disco verrà 
creato un file contenente una riga di codice BASIC, con il numero appena 
introdotto. Si può allora unire questo file ài programma di interfaccia 
Olisort usando il metodo descritto nel capitolo 5. 

Se si sceglie un'altra opzione 

Appare il seguente messaggio: 

Sort Parameter string = 

Command String 

dove Command String è la Stringa Comandi appena creata, esattamente come 
apparirebbe in un programma BASIC. 

Se si sceglie l'Opzione C la Stringa Comandi visualizzata comprende il 
numero di riga assegnatole, e apparirà il seguente messaggio: 

Olisort Parameter String successfully written 

Infine, per tutte le opzioni eccetto apparirà il seguente messaggio: 

Hit return to continue 

Per continuare, premere MiteM . La scelta di una opzione diversa da ’S' 
provoca la continuazione del programma come descritto nel paragrafo "Menu 
delle opzioni olisortx". 

Se si sceglie l’Opzione S 

Apparirà il seguente messaggio: 

Enter MSB to sort or EX to end 


Se si introduce Q il programma continua come descritto nel paragrafo 
"Menu delle opzioni olisortx". 

Se si vuole eseguire il sort, caricare il disco contenente i file di 

input e il file parametri di input (per i Modi 0 e 1) nel drive 

specificato. Verificare che il disco Olisort sia caricato nel drive 

indicato. Premere Hi : Olisort inizia l'elaborazione, come indicato nella 
Stringa Comandi appena creata. 

Un codice di stato errato, rilevato durante 1‘elaborazione, viene 

riportato sullo schermo e l'olisortx termina. 11 prompt BASIC riappare. 
Per un elenco completo dei codici di stato e relativi significati, vedere 
l'appendice E. 

Se non vengono riscontrati errori, Olisort fornisce i seguenti messaggi. 
Calling OLISORT 

SORT INPUT AND SELECT PHASE 
RECORDS READ OR SK1PPED = n 
RECORDS SELECTED = in 
OUTPUT PHASE 

« RECORDS WR1TTEN TO FILE 

OLISORT successfully completed 
Hit return to continue 

dove: 

n e «sono interi 

11 file di output elaborato ora esiste come specificato nel parametro 
o:output. 

Prima di continuare premere ed il programma continuerà come 

descritto nel paragrafo "Menu delle opzioni olisortx". 
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DESCRIZIONE DEL CAPITOLO 


Viene qui descritto l'usò del programma di utilità olisortp (di tipo 
autoesplicativo), che consente la creazione interattiva di file parame¬ 
tri. 

Questo capitolo è dedicato ad utenti non esperti; fornisce pertanto delle 
informazioni che, a seconda del livello di conoscenza, possono a volte 
sembrare superflue. 


CONTENUTI 

GENERALITÀ' 7-1 

MESSAGGI D'ERRORE STANDARD 7-1 

ESECUZ IONE DI olisortp 7-1 

MENU DELLE OPZIONI OLISORTP 7-2 

INTRODUZIONE CHIAVI DI SORT 7-4 

INTRODUZIONE CHIAVI DI 7-5 

SELECT/EXCLUDE 


SCRITTURA DEL FILE PARAMETRI 7-6 


PROGRAMMA DI UTILITÀ' olisortp 


GENERALI TÀ 1 

11 programma di utilità olisortp risiede su disco Olisort con il nome 
olisortp.bas. 

Olisortp serve principalmente a: 

- creare un file parametri e memorizzarlo su disco 

- visualizzare un file parametri. 


MESSAGGI D’ERRORE STANDARD 

11 programma di utilità olisortp permette di costruire un file parametr. 
tramite una serie di prompt che appaiono sullo schermo. La risposta ac 
ognuno di questi prompt deve essere chiusa premendo il tasto HH . 

Può apparire il seguente messaggio d’errore: 

»lnvalid Response. Please re-enter. 

Si deve allora re-impostare la risposta assicurandosi che sia entro 1 
limiti definiti nel prompt. 

ESECUZIONE DI olisortp 

Entrare in ambiente BASIC, con il disco Olisort nel drive 0, come 
descritto nel capitolo 3. 

Quando appare il prompt BASIC introdurre la seguente istruzione: 




MENU DELLE OPZIONI OLISORTP 

Sullo schermo appare quanto segue: 


Si introduce ora | 
intendono eseguire. 


Se si sceglie l'opzione E 


|, oppure Wi a seconda delle operazioni che si 


Appare il seguente messaggio: 

Ending OLISORTP 

e il programma termina. Appare il prompt BASIC. 

Se si sceglie un'altra opzione 
Appare il seguente messaggio: 

Enter drive l.D. of file parametri (0-1): 

Introdurre il numero del drive che ospita il disco contenente il file 
parametri da visualizzare, o su cui si vuole scrivere il file parametri 
che si sta creando. Appare il seguente messaggio: 
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Enter parameter file name 

Introdurre il nome del file parametri che si vuole visualizzare o creare. 
Se si sceglie l'opzione 0 

Può apparire il seguente messaggio d'errore: 

File not found 

In questo caso verificare che l'apposito disco sia montato nell'apposito 
drive. Se si vuole verificare il contenuto di un disco, si può usare il 
metodo descritto nel capitolo 3, paragrafo "Listing dei contenuti di un 
disco". 

11 file parametri, se trovato, viene visualizzato sullo schermo seguito 
dal messaggio: 

Hit return to continue 

Premere B3- Il programma continua come descritto nel paragrafo "Menu 
delle opzioni olisortp",. 

Se si sceglie l'opzione C 

11 prompt invita a introdurre una lista di parametri. La tabella 7-1 
riporta una lista dei prompt e dei corrispondenti parametri indicati 
nella loro forma abbreviata come nel pieghevole alla fine del capitolo 4 
e nel Compendio istruzioni. 


PROMPT OLISORTP 

Enter drive 1.0. for input file (0,1,10,11,12) 
Enter input file name: 

Enter drive for output file (0,1,10,11,12) 
Enter output file name: 

Enter number of records to skip (0-32767) 

Enter record length: 


PARAMETRO DA 
INTRODURRE 

il 


inputl 

o 

output 

skp 

ri 


cw 


Change work disk? (Y/N): 

Change output disk? (Y/N) 

Enter drive 1.0. for work file (0,1,10,11,12) 
Tabella 7-1 Parametri per olisortp. 


INTRODUZIONE CHIAVI DI SORT 

Appare il seguente prompt: 

Enter number 'of sort keys (0-10): 

Si deve introdurre un numero intero compreso fra 0 e 10, che specifichi 
il numero delle chiavi di sort che si vogliono creare. La digitazione di 
0 indica che non si introdurranno chiavi sort; continuare quindi- con 
l'introduzione chiavi di Select/Exclude. 

L'introduzione di qualsiasi altro numero / 0 provoca la visualizzazione 
di un messaggio che richiede l'introduzione di ogni singola chiave di 
sort: 

Enter parameters for sort key n 

Dove "n" è il numero della chiave di sort da introdurre subito dopo. 

La tabella 7-2 illustra i prompt per ogni chiave di sort ed i parametri 
da introdurre, indicati nella forma abbreviata come nel pieghevole alla 
fine del capitolo 4 e nel Compendio istruzioni. 


PROMPT CHIAVI DI SORT 

PARAMETRI 

NOTE 

Starting pósition (1-rl) 

fs 

Dove ri = valore richie¬ 
sto in precedenza. 

Key length (1-n) 

fi 

Dove n = ri - fs. Se si 
introduce un valore più 


grande di n appare il 
seguente messaggio d'er¬ 
rore : 

» key extends past end 
of record 


7 - 
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PROGRAMMA DI UTILITÀ' olisortp 


Introdurre un valore in¬ 
feriore a n. 


Field Type: ft 

(A=Alpha H=Hex l=Int 
S=Sngl.Prec D=Dbl.Prec) 

Sort in Ascending or ad 

Descending order (A/O) 

Tabella 7-2 Prompt chiavi di sort 

Dopo l'introduzione dell'ultima chiave di sort, viene richiesta l'intro¬ 
duzione di qualsiasi chiave di Select/Exclude. 


INTRODUZIONE CHIAVI DI SELECT/EXCLUDE 
Appare il seguente messaggio: 

Enter thè number of select keys (0-4); 

Si deve introdurre un numero compreso tra 1 e 4 che specifichi il numero 
di chiavi di SELECT/EXCLUDE che si vogliono creare. Se si introduce 0 non 
si creano chiavi e si può continuare con la scrittura File Parametri. 

L'introduzione di un numero compreso fra 1 e 4 provoca una richiesta di 
introduzione delle singole chiavi di SELECT/EXCLUDE. 

La tabella 7-3 illustra i prompt per ogni chiave di SELECT/EXCLUDE ed i 
parametri da introdurre, riportati nella forma abbreviata, come nel 
pieghevole alla fine del capitolo 4 e sul Compendio istruzioni. 


PROMPT CHIAVI DI 
SELECT/EXCLUDE 


PARAMETRI 


NOTE 


Starting position (1-rl) 


fs Dove ri = valore richie¬ 

sto in precedenza. 


Key length (1-n) fi Dove n = ri - fs. Se si 

introduce un valore più 
grande di n appare il 
seguente messaggio d'er-. 


rore: 





»key extends past end 
of record 


BField Type: 

; (A-Alpha H=Hex l=Int 
5=Sngl.Prec D=0bl.Prec) 

pRetain or Delete (R/D) 

Comparison type: 

(L=less than E=equal to 
iìi G=greater than) 

Select key value: 


valore 

chiave 


Introdurre un valore in¬ 
feriore a n. 


Tabella 7-3 Prompt chiavi di selezione/esclusione 

"Dopo l'introduzione dell'ultima chiave di selezione/esclusione il file 
arametri creato verrà visualizzato come descritto nel paragrafo 
segue. 


SCRITTURA DEL FILE PARAMETRI 

1|- ; :11 file parametri viene ora visualizzato sullo schermo seguito dal 
|p messaggio: 

Parameter File successfully created 
Hit return to continue 

Ora sul disco è presente un file parametri cui si può fare riferimento da 
una stringa comandi. 

t Premere il tasto BUM- 

11 programma continuerà come descritto nel paragrafo "Menu delle opzioni 
olisortp". 
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B. COPIE DI BACKUP 








DESCRIZIONE DELL'APPENDICE 


Vengono qui descritte le modalità di esecuzione di una copia di backup e 
di recupero da disco originale in caso di guasto macchina o caduta di 
tensione. 


CONTENUTI 

ESECUZIONE 01 UNA COPIA DI B-1 
BACKUP 

RIPRISTINO DAL DISCO B-2 

ORIGINALE 






t sempre raccomandabile tenere uno o più copie di backup di tutti i 
dischi che contengono informazioni importanti. Si raccomanda di tenere le 
copie dei dischi originali che accompagnano il package applicativo. 

In questa appendice sono descritte due procedure: una per eseguire una 
copia di backup, e una per operazioni di recupero da una copia di backup 
in caso di errore imprevedibile durante l'uso di un disco, ad esempio 
caduta di tensione, danneggiamento fisico dei dischi, ecc. 

Per eseguire una copia di backup serve un disco formattato. Per le 
operazioni di recupero da una copia di backup talvolta serve un disco 
formattato, cioè: 

- un disco usato che contiene informazioni superate, formattato con il 
comando PCOS VFORMAT (appendice C) 

- un disco preformattato Olivetti 

- un disco nuovo Olivetti formattato col comando PCOS VFORMAT 
(appendice C). 


ESECUZIONE DI UNA COPIA DI BACKUP 

1. Accendere l'M20 come descritto nel capitolo 3, sezione "Accensione e 
spegnimento". 

2. Caricare un disco di sistema PCOS (come illustrato in figura 1-1) nel 
drive di destra, e il disco che si vuole copiare nel drive di 
sinistra. 

Assicurarsi che entrambi i dischi siano protetti in scrittura, come 
descritto nell'appendice A. 

3. Digitare: 

4. Appare il seguente messaggio: 

Warning - vcopy deletes all files. Copy disk? (y/n) 


Se appare un messaggio diverso, probabilmente è stato commesso un 
errore di digitazione; in questo caso ritornare al punto 3. 





5. Togliere il disco di sistema dal drive di destra e inserire il disco 
su cui si vuole copiare. Questo disco non deve essere protetto in 
scrittura. Digitare: 

n gì 

6. Il disco nel drive di sinistra viene copiato in un paio di mi'nuti su 
quello del drive di destra. Quando la procedura di copiatura è 
terminata, appare il prompt PC05 > . Si possono allora togliere i 
dischi. 


RIPRI STINO DAL DISCO ORIGINALE 

Vi sono due diverse situazioni in cui può essere necessaria l'operazione 
di ripristino dall'originale: 

- il disco che si sta ripristinando è stato danneggiato fisicamente 

- il disco che si sta ripristinando non è danneggiato fisicamente ma le 
informazioni non sono più attendibili. 

Nel primo caso si butta via il disco danneggiato e si prende un disco 
formattato per eseguire l'operazione di ripristino, come descritto in 
precedenza in questa appendice. 

Nel secondo caso si può ripristinare l'informazione sul disco stesso. 

In entrambi i casi la procedura è la stessa descritta per eseguire la 
copia di backup. Si ripristina dalla copia originale eseguendo una nuova 
copia di backup dell'originale. 
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DESCRIZIONE DELL' APPENDICE 


Si descrivono le modalità di formattazione di un disco nuovo o 
vecchio disco da riciclare. 


di un 




FORMATTAZIONE DISCHI 


Prima di usare un disco nuovo o per riciclare un disco vecchio, occorre 
formattarlo con la procedura riportata di seguito. 

Prendere il disco di sistema come illustrato in figura 1-1. Deve essere 
già protetto in scrittura; se non lo è, eseguire l'operazione di 
protezione come descritto nell'appendice A. 

Accendere l'M20 e caricare il disco di sistema nel drive di destra 
(capitolo 3). Premere il tasto 

Quando appare il prompt PCOS >, continuare come descritto qui di seguito. 

Caricare il disco che si vuole formattare nel drive di destra. Questo 
disco non deve essere protetto in scrittura. Digitare quanto segue; 

ra u EGoaa una&i 

Appare un messaggio simile al seguente: 

Volume Format Rev 1.1.0.d 

Warning: VFORMAT deletes all files. Format disk? (y/n) 

che è un promemoria per l'operatore affinchè non distrugga accidentalmen¬ 
te il disco sbagliato. A questo punto si prende il disco dal drive di 
sinistra e lo si verifica. Quando si è sicuri di aver caricato il disco 
corretto digitare; 

n wa 

Se il disco che si sta formattando è nuovo, la formattazione inizia 
immediatamente e termina con il messaggio: 

Formatting Completed 

Se si sta riformattando un vecchio disco, può apparire uno (o entrambi) 
dei seguenti messaggi: 

Diskette appears password protected. Format disk? (y/n) 

Diskette appears ORE formatted. Format disk anyway? (y/n) 




Se il disco da formattare è posizionato correttamente sul drive di 
destra, digitare: 

B1 ESI 

in risposta ad entrambi i messaggi. 

ÌLa procedura di formattazione inizierà come descritto in precedenza. 

Quando il disco è stato formattato, toglierlo dal drive di destra ed 
; usarlo per eseguire copie di backup, salvataggio di file, ecc. 
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DESCR121ONE DELL’APPENDICE 

Viene riportato un elenco completo dei messaggi d'errore che possono 
essere emessi usando l'M20. Ciò permette di correggere tali errori senza 
fare riferimento ai manuali BASIC o PCOS. In caso di errore persistente, 
rivolgersi ad un programmatore BASIC. 




MtbòAbbi U1 tRRORt PCOS h BASIC 


Gli errori ritornati da un interprete BASIC non sono visualizzati con il 
loro numero d'errore (viene visualizzata solo la descrizione). Gli errori 
ritornati dal PCOS sono visualizzati sia con il numero d'errore che con 
la descrizione, ad esempio: 

sf%n,pr2400?15,12 

errar 90 in parameter 2 

Questi elenchi di codice d'errore talvolta riportano commenti che ne 
spiegano le cause e/o indicano all'utente un possibile intervento. 

Ci sono in tutto 256 codici d'errore BASIC e 127 codici d'errore PCOS, 
comunque nè PCOS nè BASIC usano tutti 1 codici disponibili. In BASIC i 
codici d'errore non usati visualizzano il messaggio "Unprintable error". 
In PCOS i codici d'errore non usati visualizzano il numero d'errore senza 
alcun messaggio. 1 codici d'errore non usati non sono elencati in questa 
appendice. 


ERRORI BASIC 


CODICE 

ERRORE 


MESSAGGI 


COMMENTI 


1 Next without POR 

2 Syntax errar 


3 RETURN without GOSUB 


4 Out of data 


5 II legai function cali 


E* stata rilevata una istruzione 
NEXT senza il corrispondente FOR 

E' stata incontrata una linea che 
contiene una sequenza di caratteri 
non corretta (parola chiave errata, 
errori di punteggiatura, ecc. ) 

E' stato incontrato un RETURN per 
cui non c'era il precedente corri¬ 
spondente GOSUB 

E' stata eseguita un'istruzione READ 
quando non c'erano istruzioni DATA, 
lasciando dati non letti nel pro¬ 
gramma 

Ad una funzione stringa o numerica è 
stato passato un parametro fuori 
gamma. 

Questo errore può verificarsi quando: 
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a. Un indice di vettore e negativo o 
troppo grande. 

b. E' stata assegnata una indicazio¬ 
ne negativa o nulla a una funzio¬ 
ne log. 

c. E' stato assegnato un valore 
negativo a una funzione SQR. 

d. Un numero negativo ha un esponen¬ 
te non intero. 

e. E' stata chiamata una funzione 
USR senza aver stabilito l’indi¬ 
rizzo iniziale. 

f. In una -ielle seguenti funzioni: 
MID$, LEFT$, R1GHT$, TAB, SPC, 
STRING5, SPACES$, 1NSTR, ON...- 
GOTO è stata data una indicazione 
errata. 

Overflow 11 risultato di un calcolo è troppo 

grande per essere rappresentato nel 
formato numerico BASIC 

Nota: Con underflow, il risultato è 
considerato 0, e l'esecuzione conti¬ 
nua senza indicazione di errore. 

Un programma è troppo grande, o ha 
troppi loop, GOSUB, variabili, o ha 
espressioni troppo complicate da 
valutare 

Undefined line Da un GOTO, GOSUB, 1F..THEN..ELSE o 

DELETE si fa riferimento ad una 
linea non esistente. 

Subscript out of range Riferimento a un elemento vettore da 

parte di un indice fuori dalle 
dimensioni del vettore stesso o con 
un numero di indici errato. 


Out of memory 
(usato anche in PCOS) 
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MESSAGGI DI ERRORE PCOS E BASIC 


10 Duplicate definition 


11 Division by zero 


12 ■lllegal direct 


13 Type mismatch 

(usato anche in PCOS) 


Date due istruzioni DIM per lo 
stesso vettore oppure applicata una 
istruzione DIM anche ad un vettore 
per il quale era stato stabilito in 
precedenza un valore di default = 
10 . 

Riscontrata una divisione per zero, 
o il valore zero è stato elevato ad 
una potenza negativa. Nel primo caso 
il risultato è infinito (con il 
segno appropriato), .nel secondo caso 
il risultato è infinito positivo. 

Istruzione non valida in modo imme¬ 
diato (diretto) è stata introdotta 
come comando immediato. 

Ad un nome di variabile stringa è 
stato assegnato un valore numerico o 
viceversa; ad una funzione che 
aspetta una indicazione numerica è 
stato dato un valore stringa o 
viceversa. 


14 Out of string space 11 BASIC, a causa di variabili 

stringa, ha superato la parte di 
memoria utente rimasta libera. (Al¬ 
loca spazio dinamicamente fino a che 
supera la dimensione di memoria). 

15 String too long Tentata creazione di una stringa più 

lunga di 255 caratteri. 

Espressione stringa troppo lunga o 
troppo complessa per essere esegui¬ 
ta. Va spezzata in espressioni più 
piccole. 

17 Can't continue Tentata continuazione di un program¬ 

ma che non può essere continuato: 


16 String formula too 
complex 


- bloccato per un errore 

- modificato durante un break in 
fase di esecuzione 

- inesistente in memoria utente. 
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MESSAGGI DI ERRORE PCOS E BASIC 


36 Unable to create window 


37 Invalid action verb 


38 Parameter out of range 


39 Too many dimensiona 


50 Field overflow 


51 Internai error 

(usato anche in PCOS) 


52 Bad file number 


53 File not found 

(usato anche in PCOS) 


54 Bad file mode 

(usato anche in PCOS) 


55 File already open 

(usato anche in PCOS) 


La finestra da creare è troppo 
grande o troppo piccola per il suo 
modo (grafico o testo). 

Verbo d'azione scritto o usato in 
modo non corretto. 

Uno o più parametri sono andati 
oltre i limiti stabiliti per il loro 
campo. 

Tentato uso di un vettore a più di 
una dimensione in modo grafico. 

Tentata allocazione, da parte di una 
istruzione FIELD, di più byte di 
quanti indicati per la lunghezza di 
un record di un file random. 

Guasto interno. Informare il suppor¬ 
to software sulle condizioni in cui 
l'errore si è verificato. 

Un'istruzione o comando fa riferi¬ 
mento a un file (con numero di file 
fuori dal campo specificato in fase 
di inizializzazione), oppure il file 
corrispondente non è aperto. 

Un'istruzione LOAD, KILL o OPEN fa 
riferimento a un file non esistente 
sul disco. 

Tentato uso di operazióni di file 
Random (GET o PUT) con file sequen¬ 
ziale; o di operazione sequenziale 
(LOAD) con file random, o di un modo 
di file illegale con OPEN, cioè non 
A,1,0 oppure R. 

Emesso un OPEN sequenziale per un 
file aperto, o applicato un KILL a 
un file che è aperto. 
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Disk 1/0 error Errore di input/output durante un'o- 

(usato anche in PCOS) perazione di 1/0 su disco. Errore di 

terminazione, cioè PCOS/BASIC non 

può ricuperare. Premere RESET. 

File already exists 11 nome file specificato in un'i- 

(usato anche in PCOS) struzione NAME è identico ad un nome 

file già in uso sul disco. 

Disk full Tutto lo spazio disponibile di 

(usato anche in PCOS) memoria disco è stato usato. 

Input past end Istruzione INPUT eseguita dopo che 

tutti i dati sono stati assegnati o 
per un file vuoto. 

Nota : uso della funzione EOF per 

trovare la fine di un file. 

Bad record number 11 numero di record usati con 

un'istruzione GET o PUT va fuori 

campo, cioè è maggiore di 32767. 

Bad file name Formato errato di un nome file usato 

con K1LL, LOAD, OPEN o SAVE, ad 

esempio: 

- troppo lungo 

- contenente caratteri non permessi 
come spazio o trattino di divisio- 
ne/usàto anche in PCOS. 

Direct statement in file Riscontrata un'istruzione diretta 

(immediata) caricando un file in 
formato ASCII. 

L'operazione LOAD è terminata. 

Too many files Tentata creazione di un nuovo file 

(usato anche in PCOS) (usando SAVE o OPEN) quando la 

directory attuale è già piena. 

Internai error Guasto interno. Riportare all'orga¬ 

nizzazione di supporto le condizioni 
in cui il guasto si è verificato. 
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MESSAGGI DI ERRORE PCOS E BASIC 


69 Volume name not found 

70 Renarne error 

71 Volume number error 

72 Volume not enabled 

73 Invalid password 

74 Illegal disk change 

75 Urite protected 

76 Error in parameter 

77 Too many parameters 

78 File not OPEN 


Il nome di volume cui si fa riferi¬ 
mento non è trovato sui dischi 
attualmente inseriti. 

Tentato cambiamento di nome a un 
volume con un nome illegale. 

11 numero di volume specificato non 
è permesso. 

L'identificatore di volume contiene 
una password che deve essere citata". 

La password introdotta non è valida. 

Il disco è stato cambiato dopo 
l'ultima volta che il file è stato 
usato. 

Tentativo di scrittura su disco 
protetto. 

Un parametro contiene un carattere 
illegale. 

Specificati parametri in numero 
superiore al richiesto. 

Tentato accesso a un file non 
aperto. 
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ERRORI 

PCOS 

CODICE 

ERRORE 

MESSAGGI 

COMMENTI 

7 

Exceeded raemory limit 

Chiamato un programma o richiesta di 
parametri troppo grande per lo 
spazio attualmente disponibile in 
memoria. 

13 

Bad data type 

Introdotta una stringa quando è 
richiesto un valore numerico o 
viceversa. 

53 

File not found 

Non si può accedere al file cui si 
fa riferimento perchè non si trova 
sul disco abilitato. 

54 

Bad file open mode 


55 

File already open 

Tentata apertura di un file già 
aperto. 

57 

Disk I/O error 

Errore di input/output durante una 
operazione di I/O su disco. Errore 
di terminazione, cioè PC0S/BAS1C non 
può ricuperare. Premere RESET. 

58 ' 

File already exists 

Il nome file che si sta cercando di 
assegnare è identico a un nome file 
già su disco. 

60 

Disk has not been 
initialized 

Il disco cui si è fatto accesso non 
è stato inizializzato. 

61 

Disk is full 

Tutto lo spazio in memoria disco è 
usato. 

62 

EOF hit unexpectedly 


63 

Bad record number 

Numero di record fuori gamma, cioè è 
0 o maggiore di 32767. 

64 

Bad file name 

Nome file troppo lungo o contenente 
caratteri illegali. 

n-8 


0L1S0RT - GUIDA UTENTE 




MLSSAGtìi DJ LRRORt PLUS L BASIC 


71 Volume name not found 11 nome volume cui si fa riferimento 

non viene incontrato sul disco 
attualmente inserito. 

72 Name already exists 11 nome file specificato come nuovo 

nome esiste già; il file è stato 
usato per ultimo. 

76 Match failed La password specificata non è rico¬ 

nosciuta. 

77 11 lega 1 disk change II disco è stato cambiato. 

78 File is write protected Tentata scrittura su un file protet- 




to. 

79 

Copy protected file 

Tentativo di accedere a un file 
protetto in copiatura. 

90 

Error in parameter 

Lino (o più) dei parametri citati 
contiene un valore inaccettabile. 

91 

Too many parameters 

E 1 stato specificato un numero di 
parametri superiore al necessario 
per un comando. 

92 

Command not found 

E' stata introdotta una parola 
chiave non valida. 

96 

File not open 

Tentativo di accedere a un file non 
aperto. 

99 

Bad load file 


101 

Bad time or date 

E 1 stata introdotta un'ora o una 
data non valida. 

106 

Function key already 
exists 

Tentato uso di un comando PKEY per 
un tasto già allocato. 

108 

Cali user error 


110 

Time out error 


111 

Invalid device name 

Nome del dispositivo specificato 
inesistente. 
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CODICI DI STATO OLISORT 


Durante l'esecuzione di Olisort al programma chiamante viene ritornato un 
codice di stato tramite la variabile BASIC OLISORT.£RR0R%. Se si scrive 
il proprio programma BASIC si può testare questa variabile nel modo 
solito. Se si usa il programma di utilità olisortx per far girare 
Olisort, i codici di stato che danno una terminazione anormale di Olisort 
vengono riportati automaticamente. 

La seguente tabella dà una lista completa di questi codici di stato. 


CODICE D'ERRORE SIGNIFICATO 


1 LETTURA DOPO FINE FILE. Indica un malfunzionamento di 
sistema o un errore di disco. Verificare che i dischi 
non contengano informazioni sbagliate o non siano 
fisicamente danneggiati. 

2 LETTURA DATI NON SCRITTI. Come per il codice di 
errore 1. 

3 FILE NON PRESENTE ALL'APERTURA. Un file richiesto da 
Olisort non può essere trovato su nessuno dei dischi 
caricati. Verificare i dischi per vedere se contengo¬ 
no tutti i file specificati. Nel caso di cambio 
dischi assicurarsi che il disco giusto sia caricato 
al momento giusto. 

4 FUORI DALLO SPAZIO DELLA DIRECTORY. Uno dei dischi 
caricati ha una directory piena. Olisort non è in 
grado di creare uno dei suoi file. Verificare i 
dischi per cancellare file che non servono. 

5 FUORI DALLO SPAZIO DATI. Olisort non può creare uno 
dei suoi file perchè uno dei dischi caricati è pieno. 
Verificare i dischi per cancellare eventualmente dei 
file e liberare spazio su disco o usare la presta¬ 
zione di cambio disco Olisort. 

6 ERRORE DI ESTENSIONE IN SCRITTURA. Come per codice di 
errore 1. 

7 FILE NON PRESENTE ALLA CHIUSURA. Come per codice di 
errore 1. 

8 FILE NON RILEVATI IN RICERCA. Come per codice di 
errore 1. 
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DESCRIZIONE DELL'APPENDICE 


Venqono qui fornite informazioni specifiche sui file richiesti da Olisort 
ad ogni fase di elaborazione. Questa informazione è estremamente utile in 
caso di cambiamento dischi o di nuova sistemazione dei file Olisort. 


CONTEN UTI 

CA MBIO DISCH I O LISO RT F-1 

FILE OLISORT CHE DEVONO F-1 

ESSERE IN LINEA ~ 



f-ASI OLISORT 


Olisort attraversa tre fasi di elaborazioni: 

- Fase di Input dove il programma di Olisort è chiamato tramite un 
programma BASIC o un programma di utilità olisortx.. Subito dopo si ha 
il dump dell'interprete BASIC e del programma chiamante su disco nel 
file BOUMP. Quindi Olisort inizia a leggere il file di ingresso (o i 
file). 

- Fase di sort dove ha luogo il processo sort. L'Olisort continua a 
leggere il file (o i file) di ingresso e crea i file di lavoro Sort. 

- Fase di Output dove Olisort scrive il file di Output, cancella i file 
di lavoro Sort, ripristina l'interprete BASIC e il programma chiamante, 
e finalmente cancella il file BDUMP. 


CAMBIO DISCHI OLISORT 

Fra la fase di input e la fase di Sort si effettua il cambio dei dischi 
di lavoro Sort. Fra la fase di Sort e quella di output si effettua il 
cambio dei dischi di file di output. 


FILE OLISORT CHE DEVONO ESSERE IN LINEA 

I file che devono essere disponibili per Olisort durante le singole fasi 
sono: 

- Durante la Fase di Input: 

. OLISORT.BAS 

. os.cmd 

. tutti i file di Input 
. il file Parametri (se richiesto) 

. il disco su cui verrà scritto il file BDUMP. 

- Durante la Fase di Sort: 

. tutti i file di Input 

. i dischi su cui verranno scritti i file di lavoro Sort 

- Durante la Fase di Output: 

. il disco che contiene i file di lavoro Sort 
. il disco che contiene il file BDUMP 
. il disco su cui verrà scritto il file di Output. 




AVVISO 


La Ing. C.Olivetti & C.S.p.A. si riserva il diritto di apportare 
modifiche al prodotto descritto in questo manuale in qualsiasi momento e 
senza preavviso. 

Questo materiale è stato preparato da Olivetti esclusivamente per l'uso 
da parte dei propri clienti. 

Olivetti garantisce che il presente materiale costituisce, alla data di 
edizione, la più aggiornata documentazione da essa elaborata relativa al 
prodotto cui si riferisce. 

E' inteso che l'uso di detto materiale avviene da parte dell'utente 
sotto la propria responsabilità. 

Nessuna ulteriore garanzia viene pertanto prestata da Olivetti (in 
particolare per eventuali imperfezioni, incompletezze e/o difficoltà 
operative), restando espressamente esclusa ogni sua responsabilità per 
danni diretti o indiretti comunque derivanti dall'uso di tale documenta¬ 
zione. 

Tutta la documentazione è coperta da copyright. 







